﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>添加窗口组 - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The 添加窗口组 function adds a window specification to a window group, creating the group 如果 necessary." />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
<script type="text/javascript">$(function(){0<=window.navigator.userAgent.toLowerCase().indexOf("ucbrowser")&&CaoNiMaDeUc()})</script>
</head>
<body>

<h1>添加窗口组</h1>

<p>增加窗口规格到窗口组, 必要时创建组.</p>

<pre class="Syntax"><span class="func">添加窗口组</span> GroupName <span class="optional">, WinTitle, WinText, ExcludeTitle, ExcludeText</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>GroupName</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>要向其中添加此窗口规范的组的名称. 如果组不存在, 则会创建它. 组名不区分大小写.</p>
  </dd>

  <dt>WinTitle</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a>, <a href="../Concepts.htm#numbers">整数</a>或<a href="../Objects.htm">对象</a></p>
    <p>识别目标窗口的窗口标题或其他条件. 请参阅 <a href="../misc/WinTitle.htm">WinTitle</a>.</p>
  </dd>

  <dt>WinText</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>如果使用此参数, 那么它必须是目标窗口中单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 如果在使用 <a href="GroupActivate.htm">激活窗口组</a>, <a href="GroupDeactivate.htm">反激活窗口组</a> 和 <a href="GroupClose.htm">关闭窗口组</a> 时, <a href="DetectHiddenText.htm">检测隐藏文本</a> 为 ON, 则会检测到隐藏的文本元素.</p>
  </dd>

  <dt>ExcludeTitle</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>标题中含有此参数值的窗口将被排除.</p>
  </dd>

  <dt>ExcludeText</dt>
  <dd>
    <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
    <p>文本中含有此参数值的窗口将被排除.</p>
  </dd>

</dl>

<h2 id="Remarks">备注</h2>
<p>每使用此函数一次则添加一条新规则到组中. 换句话说, 一个组由窗口规格的集合组成而不是固定的窗口列表. 后面当类似 <a href="GroupActivate.htm">激活窗口组</a>的函数使用组时, 会使用这些规则中的每一条检查桌面上的每个窗口. 如果窗口匹配组里的其中一条规则, 则它被视为一个匹配.</p>
<p>尽管 <a href="SetTitleMatchMode.htm">设置标题匹配模式</a> 和 <a href="DetectHiddenWindows.htm">检测隐藏窗口</a> 不会直接影响此函数的行为, 但它们会影响其他组函数(例如 <a href="GroupActivate.htm">激活窗口组</a> 和 <a href="GroupClose.htm">关闭窗口组</a>). 它们还会影响其他任何函数的 <a href="../misc/WinTitle.htm">WinTitle</a> 参数中 ahk_group 的使用.</p>
<p>窗口组的典型用法是将相关窗口收集绑定在一起, 这可用于包含许多相关窗口的任务或有许多子窗口的程序. 例如, 如果您频繁地工作在一个图形程序或文本编辑器的多个实例时, 您可以使用热键通过 <a href="GroupActivate.htm">激活窗口组</a> 来切换此程序的每一个实例(每次一个), 而不需要使用 alt-tab 或任务栏按钮找到它们.</p>
<p>由于每组中的条目仅需要添加一次, 所以此函数通常使用在<a href="../Scripts.htm#auto">脚本启动</a>时. 添加重复的条目到组中会被忽略.</p>
<p>要在一个组中包含 <u>所有</u> 窗口(除了特殊的 Program Manager 窗口), 请使用这个例子:</p>
<pre>添加窗口组 "AllWindows"</pre>
<p>通过在 <em>WinTitle</em> 参数中指定 <code>ahk_group MyGroupName</code>, 所有的窗口函数都可以操作窗口组. 函数 <a href="WinMinimize.htm">最小化窗口</a>, <a href="WinMaximize.htm">最大化窗口</a>, <a href="WinRestore.htm">还原窗口</a>, <a href="WinHide.htm">隐藏窗口</a>, <a href="WinShow.htm">显示窗口</a>, <a href="WinClose.htm">关闭窗口</a> 和 <a href="WinKill.htm">结束窗口</a> 会对一个组中的 <strong>所有</strong> 窗口进行操作. 要仅对顶层窗口进行操作, 请参照此例:</p>
<pre>隐藏窗口 窗口存在(&quot;ahk_group <strong>MyGroup</strong>&quot;)</pre>
<p>与之相比, 其他的窗口函数(例如 <a href="WinActivate.htm">激活窗口</a> 和 <a href="WinExist.htm">窗口存在</a>) 只对组中的顶层窗口进行操作.</p>
<h2 id="Related">相关</h2>
<p><a href="GroupActivate.htm">激活窗口组</a>, <a href="GroupDeactivate.htm">反激活窗口组</a>, <a href="GroupClose.htm">关闭窗口组</a></p>
<h2 id="Examples">示例</h2>
<div class="ex" id="ExIE">
<p><a href="#ExIE">#1</a></p>
<pre><em>; 在脚本顶部的自动执行段:</em>
添加窗口组 "MSIE", "ahk_class IEFrame" <em>; 只添加 Internet Explorer 窗口到该组.</em>
返回 <em>; 自动执行段的结束.</em>

<em>; 设置一个热键激活该组, 它会遍历
; 打开的所有 MSIE 窗口, 每次一个
; (即每次使用热键时激活一个窗口).</em>
Numpad1::激活窗口组 "MSIE", "r"</pre>
</div>

<div class="ex" id="ExOutlook">
  <p><a href="#ExOutlook">#2</a>: 这是用于 MS Outlook 2002 的更复杂的组.<p>
  <pre><em>; 在脚本顶部的自动执行段:</em>
设置标题匹配模式 2
添加窗口组 "mail", "Message - Microsoft Word" <em>; This is 遍历 mails currently being composed</em>
添加窗口组 "mail", "- Message (" <em>; 用于已打开的项目
; 需要附加文本以避免激活错误窗口:</em>
添加窗口组 "mail", "Advanced Find", "Sear&amp;ch 遍历 the word(s)"
添加窗口组 "mail", , "Recurrence:"
添加窗口组 "mail", "Reminder"
添加窗口组 "mail", "- Microsoft Outlook"
返回  <em>; 自动执行段的结束.</em>

Numpad5::激活窗口组 "mail" <em>; 设置一个热键用于激活每个 Outlook 窗口(每次一个).</em></pre>
</div>

</body>
</html>